home *** CD-ROM | disk | FTP | other *** search
/ PC World 2006 July & August / PCWorld_2006-07-08_cd.bin / komunikace / apache / apache_2[1].2.2-win32-x86-no_ssl.msi / Data1.cab / _C8415EC7E3F5ED1F9130A484DCC2124D < prev    next >
Extensible Markup Language  |  2006-01-15  |  60KB  |  943 lines

  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
  4.         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  5.               This file is generated from xml source: DO NOT EDIT
  6.         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  7.       -->
  8. <title>mod_mime - Apache HTTP Server</title>
  9. <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10. <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11. <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12. <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13. <body>
  14. <div id="page-header">
  15. <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  16. <p class="apache">Apache HTTP Server Version 2.2</p>
  17. <img alt="" src="../images/feather.gif" /></div>
  18. <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
  19. <div id="path">
  20. <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.2</a> > <a href="./">Modules</a></div>
  21. <div id="page-content">
  22. <div id="preamble"><h1>Apache Module mod_mime</h1>
  23. <div class="toplang">
  24. <p><span>Available Languages: </span><a href="../en/mod/mod_mime.html" title="English"> en </a> |
  25. <a href="../ja/mod/mod_mime.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
  26. </div>
  27. <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Associates the requested filename's extensions
  28.     with the file's behavior (handlers and filters)
  29.     and content (mime-type, language, character set and
  30.     encoding)</td></tr>
  31. <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr>
  32. <tr><th><a href="module-dict.html#ModuleIdentifier">ModuleáIdentifier:</a></th><td>mime_module</td></tr>
  33. <tr><th><a href="module-dict.html#SourceFile">SourceáFile:</a></th><td>mod_mime.c</td></tr></table>
  34. <h3>Summary</h3>
  35.  
  36.     <p>This module is used to associate various bits of "meta
  37.     information" with files by their filename extensions. This
  38.     information relates the filename of the document to it's
  39.     mime-type, language, character set and encoding. This
  40.     information is sent to the browser, and participates in content
  41.     negotiation, so the user's preferences are respected when
  42.     choosing one of several possible files to serve. See
  43.     <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> for more information
  44.     about <a href="../content-negotiation.html">content negotiation</a>.</p>
  45.  
  46.     <p>The directives <code class="directive"><a href="#addcharset">AddCharset</a></code>, <code class="directive"><a href="#addencoding">AddEncoding</a></code>, <code class="directive"><a href="#addlanguage">AddLanguage</a></code> and <code class="directive"><a href="#addtype">AddType</a></code> are all used to map file
  47.     extensions onto the meta-information for that file. Respectively
  48.     they set the character set, content-encoding, content-language,
  49.     and <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME-type</a> (content-type) of documents.  The directive <code class="directive"><a href="#typesconfig">TypesConfig</a></code> is used to specify a
  50.     file which also maps extensions onto MIME types. </p>
  51.  
  52.     <p>In addition, <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> may define the <a href="../handler.html">handler</a> and <a href="../filter.html">filters</a> that originate and process
  53.     content.  The directives <code class="directive"><a href="#addhandler">AddHandler</a></code>, <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code>, and <code class="directive"><a href="#addinputfilter">AddInputFilter</a></code> control the modules
  54.     or scripts that serve the document.  The <code class="directive"><a href="#multiviewsmatch">MultiviewsMatch</a></code> directive allows
  55.     <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> to consider these file extensions
  56.     to be included when testing Multiviews matches.</p>
  57.  
  58.     <p>While <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> associates meta-information
  59.     with filename extensions, the <code class="module"><a href="../mod/core.html">core</a></code> server
  60.     provides directives that are used to associate all the files in a
  61.     given container (<em>e.g.</em>, <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, or <code class="directive"><a href="../mod/core.html#files"><Files></a></code>) with particular
  62.     meta-information. These directives include <code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code>, <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>, <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>, and <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>.  The core directives
  63.     override any filename extension mappings defined in
  64.     <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>.</p>
  65.  
  66.     <p>Note that changing the meta-information for a file does not
  67.     change the value of the <code>Last-Modified</code> header.
  68.     Thus, previously cached copies may still be used by a client or
  69.     proxy, with the previous headers. If you change the
  70.     meta-information (language, content type, character set or
  71.     encoding) you may need to 'touch' affected files (updating
  72.     their last modified date) to ensure that all visitors are
  73.     receive the corrected content headers.</p>
  74. </div>
  75. <div id="quickview"><h3 class="directives">Directives</h3>
  76. <ul id="toc">
  77. <li><img alt="" src="../images/down.gif" /> <a href="#addcharset">AddCharset</a></li>
  78. <li><img alt="" src="../images/down.gif" /> <a href="#addencoding">AddEncoding</a></li>
  79. <li><img alt="" src="../images/down.gif" /> <a href="#addhandler">AddHandler</a></li>
  80. <li><img alt="" src="../images/down.gif" /> <a href="#addinputfilter">AddInputFilter</a></li>
  81. <li><img alt="" src="../images/down.gif" /> <a href="#addlanguage">AddLanguage</a></li>
  82. <li><img alt="" src="../images/down.gif" /> <a href="#addoutputfilter">AddOutputFilter</a></li>
  83. <li><img alt="" src="../images/down.gif" /> <a href="#addtype">AddType</a></li>
  84. <li><img alt="" src="../images/down.gif" /> <a href="#defaultlanguage">DefaultLanguage</a></li>
  85. <li><img alt="" src="../images/down.gif" /> <a href="#modmimeusepathinfo">ModMimeUsePathInfo</a></li>
  86. <li><img alt="" src="../images/down.gif" /> <a href="#multiviewsmatch">MultiviewsMatch</a></li>
  87. <li><img alt="" src="../images/down.gif" /> <a href="#removecharset">RemoveCharset</a></li>
  88. <li><img alt="" src="../images/down.gif" /> <a href="#removeencoding">RemoveEncoding</a></li>
  89. <li><img alt="" src="../images/down.gif" /> <a href="#removehandler">RemoveHandler</a></li>
  90. <li><img alt="" src="../images/down.gif" /> <a href="#removeinputfilter">RemoveInputFilter</a></li>
  91. <li><img alt="" src="../images/down.gif" /> <a href="#removelanguage">RemoveLanguage</a></li>
  92. <li><img alt="" src="../images/down.gif" /> <a href="#removeoutputfilter">RemoveOutputFilter</a></li>
  93. <li><img alt="" src="../images/down.gif" /> <a href="#removetype">RemoveType</a></li>
  94. <li><img alt="" src="../images/down.gif" /> <a href="#typesconfig">TypesConfig</a></li>
  95. </ul>
  96. <h3>Topics</h3>
  97. <ul id="topics">
  98. <li><img alt="" src="../images/down.gif" /> <a href="#multipleext">Files with Multiple Extensions</a></li>
  99. <li><img alt="" src="../images/down.gif" /> <a href="#contentencoding">Content encoding</a></li>
  100. <li><img alt="" src="../images/down.gif" /> <a href="#charset-lang">Character sets and languages</a></li>
  101. </ul><h3>See also</h3>
  102. <ul class="seealso">
  103. <li><code class="directive"><a href="../mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code></li>
  104. <li><code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code></li>
  105. <li><code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code></li>
  106. <li><code class="directive"><a href="../mod/core.html#defaulttype">DefaultType</a></code></li>
  107. <li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li>
  108. <li><code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code></li>
  109. <li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li>
  110. </ul></div>
  111. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  112. <div class="section">
  113. <h2><a name="multipleext" id="multipleext">Files with Multiple Extensions</a></h2>
  114.     <p>Files can have more than one extension, and the order of the
  115.     extensions is <em>normally</em> irrelevant. For example, if the
  116.     file <code>welcome.html.fr</code> maps onto content type
  117.     <code>text/html</code> and language French then the file
  118.     <code>welcome.fr.html</code> will map onto exactly the same
  119.     information.  If more than one extension is given which maps onto
  120.     the same type of meta-information, then the one to the right will
  121.     be used, except for languages and content encodings. For example,
  122.     if <code>.gif</code> maps to the <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME-type</a>
  123.     <code>image/gif</code> and <code>.html</code> maps to the
  124.     MIME-type <code>text/html</code>, then the file
  125.     <code>welcome.gif.html</code> will be associated with the
  126.     MIME-type <code>text/html</code>.</p>
  127.  
  128.     <p><a href="#charset-lang">Languages</a> and <a href="#contentencoding">content encodings</a> are treated accumulative, because one can assign
  129.     more than one language or encoding to a particular resource. For example,
  130.     the file <code>welcome.html.en.de</code> will be delivered with
  131.     <code>Content-Language: en, de</code> and <code>Content-Type:
  132.     text/html</code>.</p>
  133.  
  134.     <p>Care should be taken when a file with multiple extensions
  135.     gets associated with both a <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME-type</a> and a handler. This will
  136.     usually result in the request being by the module associated
  137.     with the handler. For example, if the <code>.imap</code>
  138.     extension is mapped to the handler <code>imap-file</code> (from
  139.     <code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code>) and the <code>.html</code> extension is
  140.     mapped to the MIME-type <code>text/html</code>, then the file
  141.     <code>world.imap.html</code> will be associated with both the
  142.     <code>imap-file</code> handler and <code>text/html</code> MIME-type.
  143.     When it is processed, the <code>imap-file</code> handler will be used,
  144.     and so it will be treated as a <code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code> imagemap
  145.     file.</p>
  146. </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  147. <div class="section">
  148. <h2><a name="contentencoding" id="contentencoding">Content encoding</a></h2>
  149.     <p>A file of a particular <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME-type</a> can additionally be encoded a
  150.     particular way to simplify transmission over the Internet.
  151.     While this usually will refer to compression, such as
  152.     <code>gzip</code>, it can also refer to encryption, such a
  153.     <code>pgp</code> or to an encoding such as UUencoding, which is
  154.     designed for transmitting a binary file in an ASCII (text)
  155.     format.</p>
  156.  
  157.     <p>The <a href="http://www.ietf.org/rfc/rfc2616.txt">HTTP/1.1
  158.     RFC</a>, section 14.11 puts it this way:</p>
  159.  
  160.     <blockquote cite="http://www.ietf.org/rfc/rfc2616.txt">
  161.       <p>The Content-Encoding entity-header field is used as a modifier to
  162.       the media-type. When present, its value indicates what additional
  163.       content codings have been applied to the entity-body, and thus what
  164.       decoding mechanisms must be applied in order to obtain the media-type
  165.       referenced by the Content-Type header field. Content-Encoding is
  166.       primarily used to allow a document to be compressed without losing
  167.       the identity of its underlying media type.</p>
  168.     </blockquote>
  169.  
  170.     <p>By using more than one file extension (see <a href="#multipleext">section above about multiple file
  171.     extensions</a>), you can indicate that a file is of a
  172.     particular <em>type</em>, and also has a particular
  173.     <em>encoding</em>. </p>
  174.  
  175.     <p>For example, you may have a file which is a Microsoft Word
  176.     document, which is pkzipped to reduce its size. If the
  177.     <code>.doc</code> extension is associated with the Microsoft
  178.     Word file type, and the <code>.zip</code> extension is
  179.     associated with the pkzip file encoding, then the file
  180.     <code>Resume.doc.zip</code> would be known to be a pkzip'ed Word
  181.     document.</p>
  182.  
  183.     <p>Apache sends a <code>Content-encoding</code> header with the
  184.     resource, in order to tell the client browser about the
  185.     encoding method.</p>
  186.  
  187.     <div class="example"><p><code>Content-encoding: pkzip</code></p></div>
  188. </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  189. <div class="section">
  190. <h2><a name="charset-lang" id="charset-lang">Character sets and languages</a></h2>
  191.     <p>In addition to file type and the file encoding,
  192.     another important piece of information is what language a
  193.     particular document is in, and in what character set the file
  194.     should be displayed. For example, the document might be written
  195.     in the Vietnamese alphabet, or in Cyrillic, and should be
  196.     displayed as such. This information, also, is transmitted in
  197.     HTTP headers.</p>
  198.  
  199.     <p>The character set, language, encoding and mime type are all 
  200.     used in the process of content negotiation (See 
  201.     <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>) to determine
  202.     which document to give to the client, when there are
  203.     alternative documents in more than one character set, language, 
  204.     encoding or mime type. All filename extensions associations
  205.     created with <code class="directive"><a href="#addcharset">AddCharset</a></code>,
  206.     <code class="directive"><a href="#addencoding">AddEncoding</a></code>, <code class="directive"><a href="#addlanguage">AddLanguage</a></code> and <code class="directive"><a href="#addtype">AddType</a></code> directives
  207.     (and extensions listed in the <code class="directive"><a href="../mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code>) participate in this select process.
  208.     Filename extensions that are only associated using the <code class="directive"><a href="#addhandler">AddHandler</a></code>, <code class="directive"><a href="#addinputfilter">AddInputFilter</a></code> or <code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code> directives may be included or excluded
  209.     from matching by using the <code class="directive"><a href="#multiviewsmatch">MultiviewsMatch</a></code> directive.</p>
  210.  
  211.     <h3><a name="charset" id="charset">Charset</a></h3>
  212.       <p>To convey this further information, Apache optionally sends
  213.       a <code>Content-Language</code> header, to specify the language
  214.       that the document is in, and can append additional information
  215.       onto the <code>Content-Type</code> header to indicate the
  216.       particular character set that should be used to correctly
  217.       render the information.</p>
  218.  
  219.       <div class="example"><p><code>
  220.         Content-Language: en, fr<br />
  221.     Content-Type: text/plain; charset=ISO-8859-1
  222.       </code></p></div>
  223.  
  224.       <p>The language specification is the two-letter abbreviation
  225.       for the language. The <code>charset</code> is the name of the
  226.       particular character set which should be used.</p>
  227.     
  228. </div>
  229. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  230. <div class="directive-section"><h2><a name="AddCharset" id="AddCharset">AddCharset</a> <a name="addcharset" id="addcharset">Directive</a></h2>
  231. <table class="directive">
  232. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions to the specified content
  233. charset</td></tr>
  234. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddCharset <var>charset</var> <var>extension</var>
  235. [<var>extension</var>] ...</code></td></tr>
  236. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
  237. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  238. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  239. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  240. </table>
  241.     <p>The <code class="directive">AddCharset</code> directive maps the given
  242.     filename extensions to the specified content charset. <var>charset</var>
  243.     is the <a href="http://www.iana.org/assignments/character-sets">MIME
  244.     charset parameter</a> of filenames containing
  245.     <var>extension</var>. This mapping is added to any already in force,
  246.     overriding any mappings that already exist for the same
  247.     <var>extension</var>.</p>
  248.  
  249.     <div class="example"><h3>Example</h3><p><code>
  250.       AddLanguage ja .ja<br />
  251.       AddCharset EUC-JP .euc<br />
  252.       AddCharset ISO-2022-JP .jis<br />
  253.       AddCharset SHIFT_JIS .sjis
  254.     </code></p></div>
  255.  
  256.     <p>Then the document <code>xxxx.ja.jis</code> will be treated
  257.     as being a Japanese document whose charset is <code>ISO-2022-JP</code>
  258.     (as will the document <code>xxxx.jis.ja</code>). The
  259.     <code class="directive">AddCharset</code> directive is useful for both to
  260.     inform the client about the character encoding of the document so that
  261.     the document can be interpreted and displayed appropriately, and for <a href="../content-negotiation.html">content negotiation</a>,
  262.     where the server returns one from several documents based on
  263.     the client's charset preference.</p>
  264.  
  265.     <p>The <var>extension</var> argument is case-insensitive, and can
  266.     be specified with or without a leading dot.</p>
  267.  
  268. <h3>See also</h3>
  269. <ul>
  270. <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
  271. <li><code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code></li>
  272. </ul>
  273. </div>
  274. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  275. <div class="directive-section"><h2><a name="AddEncoding" id="AddEncoding">AddEncoding</a> <a name="addencoding" id="addencoding">Directive</a></h2>
  276. <table class="directive">
  277. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions to the specified encoding
  278. type</td></tr>
  279. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddEncoding <var>MIME-enc</var> <var>extension</var>
  280. [<var>extension</var>] ...</code></td></tr>
  281. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
  282. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  283. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  284. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  285. </table>
  286.     <p>The <code class="directive">AddEncoding</code> directive maps the given
  287.     filename extensions to the specified encoding type. <var>MIME-enc</var>
  288.     is the MIME encoding to use for documents containing the
  289.     <var>extension</var>. This mapping is added to any already in force,
  290.     overriding any mappings that already exist for the same
  291.     <var>extension</var>.</p>
  292.  
  293.     <div class="example"><h3>Example</h3><p><code>
  294.       AddEncoding x-gzip .gz<br />
  295.       AddEncoding x-compress .Z
  296.     </code></p></div>
  297.  
  298.     <p>This will cause filenames containing the <code>.gz</code> extension
  299.     to be marked as encoded using the <code>x-gzip</code> encoding, and
  300.     filenames containing the <code>.Z</code> extension to be marked as
  301.     encoded with <code>x-compress</code>.</p>
  302.  
  303.     <p>Old clients expect <code>x-gzip</code> and <code>x-compress</code>,
  304.     however the standard dictates that they're equivalent to
  305.     <code>gzip</code> and <code>compress</code> respectively. Apache does
  306.     content encoding comparisons by ignoring any leading <code>x-</code>.
  307.     When responding with an encoding Apache will use whatever form
  308.     (<em>i.e.</em>, <code>x-foo</code> or <code>foo</code>) the
  309.     client requested. If the client didn't specifically request a
  310.     particular form Apache will use the form given by the
  311.     <code>AddEncoding</code> directive. To make this long story
  312.     short, you should always use <code>x-gzip</code> and
  313.     <code>x-compress</code> for these two specific encodings. More
  314.     recent encodings, such as <code>deflate</code> should be
  315.     specified without the <code>x-</code>.</p>
  316.  
  317.     <p>The <var>extension</var> argument is case-insensitive, and can
  318.     be specified with or without a leading dot.</p>
  319.  
  320. </div>
  321. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  322. <div class="directive-section"><h2><a name="AddHandler" id="AddHandler">AddHandler</a> <a name="addhandler" id="addhandler">Directive</a></h2>
  323. <table class="directive">
  324. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the filename extensions to the specified
  325. handler</td></tr>
  326. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddHandler <var>handler-name</var> <var>extension</var>
  327. [<var>extension</var>] ...</code></td></tr>
  328. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
  329. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  330. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  331. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  332. </table>
  333.     <p>Files having the name <var>extension</var> will be served by the
  334.     specified <var><a href="../handler.html">handler-name</a></var>. This
  335.     mapping is added to any already in force, overriding any mappings that
  336.     already exist for the same <var>extension</var>. For example, to
  337.     activate CGI scripts with the file extension <code>.cgi</code>, you
  338.     might use:</p>
  339.  
  340.     <div class="example"><p><code>
  341.       AddHandler cgi-script .cgi
  342.     </code></p></div>
  343.  
  344.     <p>Once that has been put into your httpd.conf file, any file containing
  345.     the <code>.cgi</code> extension will be treated as a CGI program.</p>
  346.  
  347.     <p>The <var>extension</var> argument is case-insensitive, and can
  348.     be specified with or without a leading dot.</p>
  349.  
  350. <h3>See also</h3>
  351. <ul>
  352. <li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li>
  353. </ul>
  354. </div>
  355. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  356. <div class="directive-section"><h2><a name="AddInputFilter" id="AddInputFilter">AddInputFilter</a> <a name="addinputfilter" id="addinputfilter">Directive</a></h2>
  357. <table class="directive">
  358. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps filename extensions to the filters that will process
  359. client requests</td></tr>
  360. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddInputFilter <var>filter</var>[;<var>filter</var>...]
  361. <var>extension</var> [<var>extension</var>] ...</code></td></tr>
  362. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
  363. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  364. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  365. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  366. <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>AddInputFilter is only available in Apache 2.0.26 and
  367. later.</td></tr>
  368. </table>
  369.     <p><code class="directive">AddInputFilter</code> maps the filename extension
  370.     <var>extension</var> to the <a href="../filter.html">filters</a> which
  371.     will process client requests and POST input when they are received by
  372.     the server. This is in addition to any filters defined elsewhere,
  373.     including the <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>
  374.     directive. This mapping is merged over any already in force, overriding
  375.     any mappings that already exist for the same <var>extension</var>.</p>
  376.  
  377.     <p>If more than one filter is specified, they must be separated
  378.     by semicolons in the order in which they should process the
  379.     content. Both the filter and <var>extension</var> arguments are
  380.     case-insensitive, and the extension may be specified with or
  381.     without a leading dot.</p>
  382.  
  383. <h3>See also</h3>
  384. <ul>
  385. <li><code class="directive"><a href="#removeinputfilter">RemoveInputFilter</a></code></li>
  386. <li><code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code></li>
  387. </ul>
  388. </div>
  389. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  390. <div class="directive-section"><h2><a name="AddLanguage" id="AddLanguage">AddLanguage</a> <a name="addlanguage" id="addlanguage">Directive</a></h2>
  391. <table class="directive">
  392. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extension to the specified content
  393. language</td></tr>
  394. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddLanguage <var>MIME-lang</var> <var>extension</var>
  395. [<var>extension</var>] ...</code></td></tr>
  396. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
  397. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  398. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  399. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  400. </table>
  401.     <p>The <code class="directive">AddLanguage</code> directive maps the given
  402.     filename extension to the specified content language.
  403.     <var>MIME-lang</var> is the MIME language of filenames containing
  404.     <var>extension</var>. This mapping is added to any already in force,
  405.     overriding any mappings that already exist for the same
  406.     <var>extension</var>.</p>
  407.  
  408.     <div class="example"><h3>Example</h3><p><code>
  409.       AddEncoding x-compress .Z<br />
  410.       AddLanguage en .en<br />
  411.       AddLanguage fr .fr
  412.     </code></p></div>
  413.  
  414.     <p>Then the document <code>xxxx.en.Z</code> will be treated as
  415.     being a compressed English document (as will the document
  416.     <code>xxxx.Z.en</code>). Although the content language is
  417.     reported to the client, the browser is unlikely to use this
  418.     information. The <code class="directive">AddLanguage</code> directive is
  419.     more useful for <a href="../content-negotiation.html">content
  420.     negotiation</a>, where the server returns one from several documents
  421.     based on the client's language preference.</p>
  422.  
  423.     <p>If multiple language assignments are made for the same
  424.     extension, the last one encountered is the one that is used.
  425.     That is, for the case of:</p>
  426.  
  427.     <div class="example"><p><code>
  428.       AddLanguage en .en<br />
  429.       AddLanguage en-gb .en<br />
  430.       AddLanguage en-us .en
  431.     </code></p></div>
  432.  
  433.     <p>documents with the extension <code>.en</code> would be treated as
  434.     being <code>en-us</code>.</p>
  435.  
  436.     <p>The <var>extension</var> argument is case-insensitive, and can
  437.     be specified with or without a leading dot.</p>
  438.  
  439. <h3>See also</h3>
  440. <ul>
  441. <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
  442. </ul>
  443. </div>
  444. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  445. <div class="directive-section"><h2><a name="AddOutputFilter" id="AddOutputFilter">AddOutputFilter</a> <a name="addoutputfilter" id="addoutputfilter">Directive</a></h2>
  446. <table class="directive">
  447. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps filename extensions to the filters that will process
  448. responses from the server</td></tr>
  449. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddOutputFilter <var>filter</var>[;<var>filter</var>...]
  450. <var>extension</var> [<var>extension</var>] ...</code></td></tr>
  451. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
  452. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  453. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  454. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  455. <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>AddOutputFilter is only available in Apache 2.0.26 and
  456. later.</td></tr>
  457. </table>
  458.     <p>The <code class="directive">AddOutputFilter</code> directive maps the
  459.     filename extension <var>extension</var> to the <a href="../filter.html">filters</a> which will process responses
  460.     from the server before they are sent to the client. This is in
  461.     addition to any filters defined elsewhere, including <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code> and <code class="directive"><a href="../mod/core.html#addoutputfilterbytype">AddOutputFilterByType</a></code> directive. This mapping is merged
  462.     over any already in force, overriding any mappings that already exist
  463.     for the same <var>extension</var>.</p>
  464.  
  465.     <p>For example, the following configuration will process all
  466.     <code>.shtml</code> files for server-side includes and will then
  467.     compress the output using <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</p>
  468.  
  469.     <div class="example"><p><code>
  470.       AddOutputFilter INCLUDES;DEFLATE shtml
  471.     </code></p></div>
  472.  
  473.     <p>If more than one filter is specified, they must be separated
  474.     by semicolons in the order in which they should process the
  475.     content. Both the <var>filter</var> and <var>extension</var> arguments
  476.     are case-insensitive, and the extension may be specified with or
  477.     without a leading dot.</p>
  478.  
  479. <h3>See also</h3>
  480. <ul>
  481. <li><code class="directive"><a href="#removeoutputfilter">RemoveOutputFilter</a></code></li>
  482. <li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li>
  483. </ul>
  484. </div>
  485. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  486. <div class="directive-section"><h2><a name="AddType" id="AddType">AddType</a> <a name="addtype" id="addtype">Directive</a></h2>
  487. <table class="directive">
  488. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps the given filename extensions onto the specified content
  489. type</td></tr>
  490. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AddType <var>MIME-type</var> <var>extension</var>
  491. [<var>extension</var>] ...</code></td></tr>
  492. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
  493. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  494. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  495. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  496. </table>
  497.     <p>The <code class="directive">AddType</code> directive maps the given
  498.     filename extensions onto the specified content
  499.     type. <var>MIME-type</var> is the <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME
  500.     type</a> to use for filenames containing
  501.     <var>extension</var>. This mapping is added to any already in
  502.     force, overriding any mappings that already exist for the same
  503.     <var>extension</var>. This directive can be used to add mappings
  504.     not listed in the MIME types file (see the <code class="directive"><a href="#typesconfig">TypesConfig</a></code> directive).</p>
  505.     
  506.     <div class="example"><h3>Example</h3><p><code>
  507.       AddType image/gif .gif
  508.     </code></p></div>
  509.  
  510.     <div class="note">
  511.       It is recommended that new MIME types be added using the
  512.       <code class="directive">AddType</code> directive rather than changing the 
  513.       <code class="directive"><a href="#typesconfig">TypesConfig</a></code> file.
  514.     </div>
  515.  
  516.     <p>The <var>extension</var> argument is case-insensitive, and can
  517.     be specified with or without a leading dot.</p>
  518.  
  519. <h3>See also</h3>
  520. <ul>
  521. <li><code class="directive"><a href="../mod/core.html#defaulttype">DefaultType</a></code></li>
  522. <li><code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code></li>
  523. </ul>
  524. </div>
  525. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  526. <div class="directive-section"><h2><a name="DefaultLanguage" id="DefaultLanguage">DefaultLanguage</a> <a name="defaultlanguage" id="defaultlanguage">Directive</a></h2>
  527. <table class="directive">
  528. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets all files in the given scope to the specified
  529. language</td></tr>
  530. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>DefaultLanguage <var>MIME-lang</var></code></td></tr>
  531. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
  532. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  533. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  534. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  535. </table>
  536.     <p>The <code class="directive">DefaultLanguage</code> directive tells Apache
  537.     that all files in the directive's scope (<em>e.g.</em>, all files
  538.     covered by the current <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> container) that don't have an explicit language
  539.     extension (such as <code>.fr</code> or <code>.de</code> as configured
  540.     by <code class="directive"><a href="#addlanguage">AddLanguage</a></code>) should be
  541.     considered to be in the specified <var>MIME-lang</var> language. This
  542.     allows entire directories to be marked as containing Dutch content, for
  543.     instance, without having to rename each file. Note that unlike using
  544.     extensions to specify languages, <code class="directive">DefaultLanguage</code>
  545.     can only specify a single language.</p>
  546.  
  547.     <p>If no <code class="directive">DefaultLanguage</code> directive is in force,
  548.     and a file does not have any language extensions as configured
  549.     by <code class="directive"><a href="#addlanguage">AddLanguage</a></code>, then that file
  550.     will be considered to have no language attribute.</p>
  551.  
  552.     <div class="example"><h3>Example</h3><p><code>
  553.       DefaultLanguage en
  554.     </code></p></div>
  555.  
  556. <h3>See also</h3>
  557. <ul>
  558. <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
  559. </ul>
  560. </div>
  561. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  562. <div class="directive-section"><h2><a name="ModMimeUsePathInfo" id="ModMimeUsePathInfo">ModMimeUsePathInfo</a> <a name="modmimeusepathinfo" id="modmimeusepathinfo">Directive</a></h2>
  563. <table class="directive">
  564. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tells <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> to treat <code>path_info</code>
  565. components as part of the filename</td></tr>
  566. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ModMimeUsePathInfo On|Off</code></td></tr>
  567. <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ModMimeUsePathInfo Off</code></td></tr>
  568. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory</td></tr>
  569. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  570. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  571. <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.41 and later</td></tr>
  572. </table>
  573.     <p>The <code class="directive">ModMimeUsePathInfo</code> directive is used to
  574.     combine the filename with the <code>path_info</code> URL component to
  575.     apply <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code>'s directives to the request. The default
  576.     value is <code>Off</code> - therefore, the <code>path_info</code>
  577.     component is ignored.</p>
  578.  
  579.     <p>This directive is recommended when you have a virtual filesystem.</p>
  580.  
  581.     <div class="example"><h3>Example</h3><p><code>
  582.       ModMimeUsePathInfo On
  583.     </code></p></div>
  584.  
  585.     <p>If you have a request for <code>/bar/foo.shtml</code> where
  586.     <code>/bar</code> is a Location and <code class="directive">ModMimeUsePathInfo</code> is <code>On</code>,
  587.     <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> will treat the incoming request as
  588.     <code>/bar/foo.shtml</code> and directives like <code>AddOutputFilter
  589.     INCLUDES .shtml</code> will add the <code>INCLUDES</code> filter to the
  590.     request. If <code class="directive">ModMimeUsePathInfo</code> is not set, the
  591.     <code>INCLUDES</code> filter will not be added.</p>
  592.  
  593. <h3>See also</h3>
  594. <ul>
  595. <li><code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></li>
  596. </ul>
  597. </div>
  598. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  599. <div class="directive-section"><h2><a name="MultiviewsMatch" id="MultiviewsMatch">MultiviewsMatch</a> <a name="multiviewsmatch" id="multiviewsmatch">Directive</a></h2>
  600. <table class="directive">
  601. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The types of files that will be included when searching for
  602. a matching file with MultiViews</td></tr>
  603. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers
  604. [Handlers|Filters]</code></td></tr>
  605. <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>MultiviewsMatch NegotiatedOnly</code></td></tr>
  606. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
  607. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  608. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  609. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  610. <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.0.26 and later.</td></tr>
  611. </table>
  612.     <p><code class="directive">MultiviewsMatch</code> permits three different
  613.     behaviors for <a href="mod_negotiation.html">mod_negotiation</a>'s
  614.     Multiviews feature.  Multiviews allows a request for a file,
  615.     <em>e.g.</em> <code>index.html</code>, to match any negotiated
  616.     extensions following the base request, <em>e.g.</em>
  617.     <code>index.html.en</code>, <code>index.html.fr</code>, or
  618.     <code>index.html.gz</code>.</p>
  619.  
  620.     <p>The <code>NegotiatedOnly</code> option provides that every extension
  621.     following the base name must correlate to a recognized
  622.     <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> extension for content negotation, <em>e.g.</em>
  623.     Charset, Content-Type, Language, or Encoding.  This is the strictest
  624.     implementation with the fewest unexpected side effects, and is the
  625.     default behavior.</p>
  626.  
  627.     <p>To include extensions associated with Handlers and/or Filters,
  628.     set the <code class="directive">MultiviewsMatch</code> directive to either
  629.     <code>Handlers</code>, <code>Filters</code>, or both option keywords.
  630.     If all other factors are equal, the smallest file will be served,
  631.     <em>e.g.</em> in deciding between <code>index.html.cgi</code> of 500
  632.     bytes and <code>index.html.pl</code> of 1000 bytes, the <code>.cgi</code>
  633.     file would win in this example. Users of <code>.asis</code> files
  634.     might prefer to use the Handler option, if <code>.asis</code> files are
  635.     associated with the <code>asis-handler</code>.</p>
  636.  
  637.     <p>You may finally allow <code>Any</code> extensions to match, even if
  638.     <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> doesn't recognize the extension. This was the
  639.     behavior in Apache 1.3, and can cause unpredicatable results, such as
  640.     serving .old or .bak files the webmaster never expected to be served.</p>
  641.  
  642.     <p>For example, the following configuration will allow handlers
  643.     and filters to participate in Multviews, but will exclude unknown
  644.     files:</p>
  645.  
  646.     <div class="example"><p><code>
  647.       MultiviewsMatch Handlers Filters
  648.     </code></p></div>
  649.  
  650. <h3>See also</h3>
  651. <ul>
  652. <li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li>
  653. <li><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></li>
  654. </ul>
  655. </div>
  656. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  657. <div class="directive-section"><h2><a name="RemoveCharset" id="RemoveCharset">RemoveCharset</a> <a name="removecharset" id="removecharset">Directive</a></h2>
  658. <table class="directive">
  659. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any character set associations for a set of file
  660. extensions</td></tr>
  661. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveCharset <var>extension</var> [<var>extension</var>]
  662. ...</code></td></tr>
  663. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
  664. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  665. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  666. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  667. <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveCharset is only available in Apache 2.0.24 and
  668. later.</td></tr>
  669. </table>
  670.     <p>The <code class="directive">RemoveCharset</code> directive removes any
  671.     character set associations for files with the given extensions.
  672.     This allows <code>.htaccess</code> files in subdirectories to
  673.     undo any associations inherited from parent directories or the
  674.     server config files.</p>
  675.  
  676.     <p>The <var>extension</var> argument is case-insensitive, and can
  677.     be specified with or without a leading dot.</p>
  678.  
  679.     <div class="example"><h3>Example</h3><p><code>
  680.       RemoveCharset .html .shtml
  681.     </code></p></div>
  682.  
  683. </div>
  684. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  685. <div class="directive-section"><h2><a name="RemoveEncoding" id="RemoveEncoding">RemoveEncoding</a> <a name="removeencoding" id="removeencoding">Directive</a></h2>
  686. <table class="directive">
  687. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content encoding associations for a set of file
  688. extensions</td></tr>
  689. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveEncoding <var>extension</var> [<var>extension</var>]
  690. ...</code></td></tr>
  691. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
  692. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  693. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  694. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  695. </table>
  696.     <p>The <code class="directive">RemoveEncoding</code> directive removes any
  697.     encoding associations for files with the given extensions. This
  698.     allows <code>.htaccess</code> files in subdirectories to undo
  699.     any associations inherited from parent directories or the
  700.     server config files. An example of its use might be:</p>
  701.  
  702.     <div class="example"><h3>/foo/.htaccess:</h3><p><code>
  703.       AddEncoding x-gzip .gz<br />
  704.       AddType text/plain .asc<br />
  705.       <Files *.gz.asc><br />
  706.       <span class="indent">
  707.         RemoveEncoding .gz<br />
  708.       </span>
  709.       </Files>
  710.     </code></p></div>
  711.  
  712.     <p>This will cause <code>foo.gz</code> to be marked as being
  713.     encoded with the gzip method, but <code>foo.gz.asc</code> as an
  714.     unencoded plaintext file.</p>
  715.  
  716.     <div class="note"><h3>Note</h3>
  717.       <p><code class="directive">RemoveEncoding</code> directives are processed
  718.       <em>after</em> any <code class="directive"><a href="#addencoding">AddEncoding</a></code>
  719.       directives, so it is possible they may undo the effects of the latter
  720.       if both occur within the same directory configuration.</p>
  721.     </div>
  722.  
  723.     <p>The <var>extension</var> argument is case-insensitive, and can
  724.     be specified with or without a leading dot.</p>
  725.  
  726. </div>
  727. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  728. <div class="directive-section"><h2><a name="RemoveHandler" id="RemoveHandler">RemoveHandler</a> <a name="removehandler" id="removehandler">Directive</a></h2>
  729. <table class="directive">
  730. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any handler associations for a set of file
  731. extensions</td></tr>
  732. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveHandler <var>extension</var> [<var>extension</var>]
  733. ...</code></td></tr>
  734. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
  735. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  736. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  737. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  738. </table>
  739.     <p>The <code class="directive">RemoveHandler</code> directive removes any
  740.     handler associations for files with the given extensions. This allows
  741.     <code>.htaccess</code> files in subdirectories to undo any
  742.     associations inherited from parent directories or the server
  743.     config files. An example of its use might be:</p>
  744.  
  745.     <div class="example"><h3>/foo/.htaccess:</h3><p><code>
  746.       AddHandler server-parsed .html
  747.     </code></p></div>
  748.  
  749.     <div class="example"><h3>/foo/bar/.htaccess:</h3><p><code>
  750.       RemoveHandler .html
  751.     </code></p></div>
  752.  
  753.     <p>This has the effect of returning <code>.html</code> files in
  754.     the <code>/foo/bar</code> directory to being treated as normal
  755.     files, rather than as candidates for parsing (see the <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> module).</p>
  756.  
  757.     <p>The <var>extension</var> argument is case-insensitive, and can
  758.     be specified with or without a leading dot.</p>
  759.  
  760. </div>
  761. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  762. <div class="directive-section"><h2><a name="RemoveInputFilter" id="RemoveInputFilter">RemoveInputFilter</a> <a name="removeinputfilter" id="removeinputfilter">Directive</a></h2>
  763. <table class="directive">
  764. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any input filter associations for a set of file
  765. extensions</td></tr>
  766. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveInputFilter <var>extension</var> [<var>extension</var>]
  767. ...</code></td></tr>
  768. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
  769. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  770. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  771. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  772. <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveInputFilter is only available in Apache 2.0.26 and
  773. later.</td></tr>
  774. </table>   
  775.     <p>The <code class="directive">RemoveInputFilter</code> directive removes any
  776.     input filter associations for files with the given extensions.
  777.     This allows <code>.htaccess</code> files in subdirectories to
  778.     undo any associations inherited from parent directories or the
  779.     server config files.</p>
  780.  
  781.     <p>The <var>extension</var> argument is case-insensitive, and can
  782.     be specified with or without a leading dot.</p>
  783.  
  784. <h3>See also</h3>
  785. <ul>
  786. <li><code class="directive"><a href="#addinputfilter">AddInputFilter</a></code></li>
  787. <li><code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code></li>
  788. </ul>
  789. </div>
  790. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  791. <div class="directive-section"><h2><a name="RemoveLanguage" id="RemoveLanguage">RemoveLanguage</a> <a name="removelanguage" id="removelanguage">Directive</a></h2>
  792. <table class="directive">
  793. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any language associations for a set of file
  794. extensions</td></tr>
  795. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveLanguage <var>extension</var> [<var>extension</var>]
  796. ...</code></td></tr>
  797. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
  798. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  799. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  800. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  801. <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveLanguage is only available in Apache 2.0.24 and
  802. later.</td></tr>
  803. </table>
  804.     <p>The <code class="directive">RemoveLanguage</code> directive removes any
  805.     language associations for files with the given extensions. This
  806.     allows <code>.htaccess</code> files in subdirectories to undo
  807.     any associations inherited from parent directories or the
  808.     server config files.</p>
  809.  
  810.     <p>The <var>extension</var> argument is case-insensitive, and can
  811.     be specified with or without a leading dot.</p>
  812.  
  813. </div>
  814. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  815. <div class="directive-section"><h2><a name="RemoveOutputFilter" id="RemoveOutputFilter">RemoveOutputFilter</a> <a name="removeoutputfilter" id="removeoutputfilter">Directive</a></h2>
  816. <table class="directive">
  817. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any output filter associations for a set of file
  818. extensions</td></tr>
  819. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveOutputFilter <var>extension</var> [<var>extension</var>]
  820. ...</code></td></tr>
  821. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
  822. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  823. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  824. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  825. <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>RemoveOutputFilter is only available in Apache 2.0.26 and
  826. later.</td></tr>
  827. </table>    
  828.     <p>The <code class="directive">RemoveOutputFilter</code> directive removes any
  829.     output filter associations for files with the given extensions.
  830.     This allows <code>.htaccess</code> files in subdirectories to
  831.     undo any associations inherited from parent directories or the
  832.     server config files.</p>
  833.  
  834.     <p>The <var>extension</var> argument is case-insensitive, and can
  835.     be specified with or without a leading dot.</p>
  836.  
  837.     <div class="example"><h3>Example</h3><p><code>
  838.       RemoveOutputFilter shtml
  839.     </code></p></div>
  840.  
  841. <h3>See also</h3>
  842. <ul>
  843. <li><code class="directive"><a href="#addoutputfilter">AddOutputFilter</a></code></li>
  844. </ul>
  845. </div>
  846. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  847. <div class="directive-section"><h2><a name="RemoveType" id="RemoveType">RemoveType</a> <a name="removetype" id="removetype">Directive</a></h2>
  848. <table class="directive">
  849. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Removes any content type associations for a set of file
  850. extensions</td></tr>
  851. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>RemoveType <var>extension</var> [<var>extension</var>]
  852. ...</code></td></tr>
  853. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>virtual host, directory, .htaccess</td></tr>
  854. <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
  855. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  856. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  857. </table>
  858.     <p>The <code class="directive">RemoveType</code> directive removes any
  859.     <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME type</a> associations for files with
  860.     the given extensions. This allows <code>.htaccess</code> files in
  861.     subdirectories to undo any associations inherited from parent
  862.     directories or the server config files. An example of its use
  863.     might be:</p>
  864.  
  865.     <div class="example"><h3>/foo/.htaccess:</h3><p><code>
  866.       RemoveType .cgi
  867.     </code></p></div>
  868.  
  869.     <p>This will remove any special handling of <code>.cgi</code>
  870.     files in the <code>/foo/</code> directory and any beneath it,
  871.     causing the files to be treated as being of the <code class="directive"><a href="../mod/core.html#defaulttype">DefaultType</a></code>.</p>
  872.  
  873.     <div class="note"><h3>Note</h3>
  874.       <p><code class="directive">RemoveType</code> directives are processed
  875.       <em>after</em> any <code class="directive"><a href="#addtype">AddType</a></code>
  876.       directives, so it is possible they may undo the effects of the
  877.       latter if both occur within the same directory configuration.</p>
  878.     </div>
  879.  
  880.     <p>The <var>extension</var> argument is case-insensitive, and can
  881.     be specified with or without a leading dot.</p>
  882.  
  883. </div>
  884. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  885. <div class="directive-section"><h2><a name="TypesConfig" id="TypesConfig">TypesConfig</a> <a name="typesconfig" id="typesconfig">Directive</a></h2>
  886. <table class="directive">
  887. <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The location of the <code>mime.types</code> file</td></tr>
  888. <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TypesConfig <var>file-path</var></code></td></tr>
  889. <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>TypesConfig conf/mime.types</code></td></tr>
  890. <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
  891. <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
  892. <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_mime</td></tr>
  893. </table>
  894.     <p>The <code class="directive">TypesConfig</code> directive sets the
  895.     location of the <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME types</a>
  896.     configuration file. <var>File-path</var> is relative to the
  897.     <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. This file sets
  898.     the default list of mappings from filename extensions to content
  899.     types. Most administrators use the provided
  900.     <code>mime.types</code> file, which associates common filename
  901.     extensions with IANA registered content types. The current list is
  902.     maintained at <a href="http://www.iana.org/assignments/media-types/index.html">http://www.iana.org/assignments/media-types/index.html</a>.  This
  903.     simplifies the <code>httpd.conf</code> file by providing the
  904.     majority of media-type definitions, and may be overridden by
  905.     <code class="directive"><a href="#addtype">AddType</a></code> directives as
  906.     needed. You should not edit the <code>mime.types</code> file,
  907.     because it may be replaced when you upgrade your server.</p>
  908.  
  909.     <p>The file contains lines in the format of the arguments to
  910.     an <code class="directive"><a href="#addtype">AddType</a></code> directive:</p>
  911.  
  912.     <div class="example"><p><code>
  913.       <var>MIME-type</var> [<var>extension</var>] ...
  914.     </code></p></div>
  915.  
  916.     <p>The case of the extension does not matter. Blank lines, and lines
  917.     beginning with a hash character (<code>#</code>) are ignored.</p>
  918.  
  919.     <div class="note">
  920.       Please do <strong>not</strong> send requests to the Apache HTTP
  921.       Server Project to add any new entries in the distributed
  922.       <code>mime.types</code> file unless (1) they are already
  923.       registered with IANA, and (2) they use widely accepted,
  924.       non-conflicting filename extensions across platforms.
  925.       <code>category/x-subtype</code> requests will be automatically
  926.       rejected, as will any new two-letter extensions as they will
  927.       likely conflict later with the already crowded language and
  928.       character set namespace.
  929.     </div>
  930.  
  931. <h3>See also</h3>
  932. <ul>
  933. <li><code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code></li>
  934. </ul>
  935. </div>
  936. </div>
  937. <div class="bottomlang">
  938. <p><span>Available Languages: </span><a href="../en/mod/mod_mime.html" title="English"> en </a> |
  939. <a href="../ja/mod/mod_mime.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
  940. </div><div id="footer">
  941. <p class="apache">Copyright 1995-2006 The Apache Software Foundation or its licensors, as applicable.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
  942. <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
  943. </body></html>